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System and method for determining and manipulating configuration information of servers 
in a distributed object environment 



(57) A computer system in a distributed object pro- 
gramming environment includes a number of host com- 
puters providing services to clients on a network 
through internally stored servers. Various types of con- 
figuration information for each server are available to cli- 
ents through persistent server administrators, which are 
objects containing such information about individual 
servers. A server administrator can store such informa- 



tion as startup execution definitions, saved program def- 
inition, object interfaces and implementations, reaping, 
tracing, and logging configuration data. Being persistent 
and external to the server, the server administrator can 
manipulate and determine Its information about a server 
in response to client requests without starting up the 
server, thereby facilitating system administration. 
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Description 

COPYRIGHT NOTICE 

A portion of the disclosure of this patent document contains material which is subject to copyright protection. The 
copyright owner has no objection to the facsimile reproduction by any one of the patent disclosure, as it appears in the 
Patent and Trademark Office patent files or records, but otherwise reserves all copyright rights whatsoever. 

RELATED APPLICATION 

This application is related to the European patent application entitled. SYSTEf^ AND METHOD TO CONTROL 
AND ADfy/IINISTER DISTRIBUTED OBJECT SERVERS USING FIRST CLASS DISTRIBUTED OBJECTS, our refer- 
ence FB 5842. filed simultaneously with this application. 

15 BACKGROUND 

Field of Invention 

This invention relates to the field of object oriented application and operating systems development, and more par- 
20 ticularly. to methods and systems for performing administrative operations on object oriented applications operating in 
a distributed object programming environment. 

Background of Invention 

25 Client-server computing is the predominant model for the management of computing resources, typically on a net- 
work of distributed computers. Servers are computers and application programs executing thereon that provide various 
functional operations and data, upon request. Clients are computers and applications that request such services. While 
clients and servers may be distributed in various computers on a network, they may also reside in a single computer, 
with individual applications providing client or server functions, or both. 

30 In a client-server system based on a object oriented development environment, a client is code that invokes or 
manipulates an object, and the object that is invoked is the server. A server provides a number of interfaces to clients 
for invoking various objects within the server that provide functionality requested by a client. Each of the objects may 
have multiple implementations, or object code that executes the functionality of the code when an instance of the object 
is created by the server. Thus, a particular interface, when used by a client to invoke an object, will result in the execu- 

35 tlon of a particular implementation for the object that is invoked. When the server or one of its objects is invoked, the 
server will operate in accordance with certain configuration information, such as the location of its data directory, the 
executable pathname, and the like. In a client-server system, it is desirable to be able to determine and manipulate the 
configuration information for a server available on the network without consuming system resources by invoking the 
server. 

40 Information about a server can be classified into two categories. Dynamic information arises out of a particular 
process that is executing a server, such as its process identifier, how many objects are active within the server, and the 
like. This information is dynamic because it depends on a current executing process which is transient Static informa- 
tion is information that does not devolve from a particular execution or process. This includes external information such 
as the Identify of the host computer of where the server is installed, its pathname, its execution definition, and internal 

45 information, such as the identity and description of the object interfaces and implementations the server provides, and 
the setup of various application programming interfaces used by the server, such as the identity and configuration of 
tracing facilities available in the server, log file configurations, and reaping functions. 

Conventionally, systems administrators have various software tools for determining the configuration and related 
information about servers on various computers on a network. However, these administrative tools require that the 

50 server be executing as a process for any information to be obtained, and thus require an inactive server to be started 
up. merely to obtain or manipulate configuration and similar information. Such startup procedures limit the flexibility of 
the administrative tools, and require unnecessary consumption of computer resources. This is particularly the case 
where a client needs to determine configuration information for a large number of servers on the network. 

Similarly, network managers use network management tools to determine the state of network resources, such as 

55 routers, bridges, printers, file servers, disk drives, workstations and the like. With conventional network management 
tools, such as tools compliant with the SNMP or CMIP standards, individual managed objects are associated with each 
network device. The network manager can query and configure networked devices through manipulation of the man- 
aged object associated with each device. These managed objects however, are limited to conveying information at the 
device level, and do not query or manipulate object level information for individual processes, particularly for servers 



2 



10 



15 



20 



25 



EP 0 732 834 A2 

running on workstations and similar processing units. For example. SNMP tools currently do not determine the inter- 
faces implemented by a given server on a particular workstation. Thus, these tools do not provide adequate level of 
granularity for use by a systems administrator of a client-server system built on a distributed object programming envi- 
ronment. 

Additionally. SNMP and CMIP tools require the network device associated with each managed object to be operat- 
ing and available on the network in order for the managed object to determine and configure the state of the network 
device. Conventional managed objects are unable to automatically startup their associated network devices and thus 
if the network device crashes or its othenwise terminated, the managed object and the SNMP tool is unable to provide 
information about the network device. This is because the managed objects do not have information about the startup 
configuration of the network devices, as the managed objects operate on the assumption that the associated network 
devices are already operating. Thus, these tools would also require the servers to be executing in order for any infor- 
mation to be obtained. Similarly, with low level protocols, like RPC. no information is stored about pathnames, configu- 
ration information or the like for servers, again, preventing an RPC agent from starting a networked server, or providing 
process level information. 

in conventional systems where the processes created by an application all reside in a common address space, typ- 
ical system administrative tools require providing an explicit reference to the host machine and the process or proc- 
esses for which information is requested. In a distributed object programming environment, however, a client invokes a 
server through an object reference, without having information as to where the invoked object resides in the system 
that IS, without specifically knowing the computer where the invoked object is stored or where its running. Rather the 
client passes the object reference through an object request broker which locates the server, and passes back my out- 
put from the server to the client. To the user, the client and server, and any group of distributed objects, behave trans- 
parently as an integrated application, even though the objects may be distributed in various computer systems One 
standard for the distributed object programming is the Common Object Request Broker Architecture (CORBA) speci- 
fied by the Object Management Group, In this environment, conventional system administrative tools are shielded from 
the actual implementation of the server, and do not have a mechanism for obtaining unified access to the internal struc- ' 
ture of a server, particuarly its configuration setup. While such information may be available in various objects in various 
parts of the environment, such as naming services, and the like, there is no unified object that provides this information 
access efficiently 

Accordingly, it is desirable to provide a method and system for obtaining and manipulating configuration information 
about servers on computers in a distributed object programming environment without starting up the servers and 
where only an object reference to the server is available to clients. 

SUMMARY OF THE INVENTION 

55 The present invention overcomes the foregoing limitations by associating with each server a persistent stored 
obiect known as a server administrator. The server administrator stores various types of information that can be known 
about the server without starting up the server, such as its execution definition, name, location, and various internal con- 
figuration information, such as the object interfaces and implementations supported by the server. Because the server 
administrator is persistent, it maintains the configuration information even when the server is not executing This allows 

<o the configuration information to be manipulated by clients via the server administrator, which also provides various 
methods for changing and updating the configuration information. 

The presence of a server administrator simplifies the discovery of what services the server provides through the 
object interfaces and implementations. In the absence of this information stored in the server administrator clients 
would have to start up the server to obtain this information. This process can be extremely time and resource intensive 

45 particularly where a client is attempting to determine this information for a^ery server on the network. Storing interface 
and implementation information in an object, such as the server administrator, external to the server, means that this 
information can be obtained without starting up the sender. 

The seiver administrator also provides for unified storage of startup configuration for the server, allowing a client to 
obtain and manipulate the startup configuration for many different servers by accessing their respective server admin- 

50 istrators which may be Stored in a common naming context. 

BRIEF DFSr.RIPTini^ n p THF ORAWIKirit t 
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Figure 1 is an illustration of a system of distributed computers for using server administrator objects; 
Figure 2 is an illustration of the organization of a host computer supporting various servers- 
Figure 3 IS a flowchart one embodiment of a process of registering a server with a persistent associated server 
administrator object: 

Figures 4a and 4b are data flow diagrams of the call architecture for obtaining information about a server without 
starting up the server; 
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Figure 5 is a flowchart of one embodiment of a process for interposing an application for the server; 

Figure 6 is a flowchart of one embodiment of a process for updating tracing facilities in the server; and 

Figure 7 is an illustration of one embodiment of a user interface for obtaining information about servers and host 

machines. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

Referring now to Figure 1 there is shown a hardware view of a system 100 for determining and manipulating con- 
figuration information for servers on distributed computers in a distributed object programming environment. The sys- 
tem 100 includes a number of host computers 101 connected along a network 103, Each host computer 101 includes 
secondary storage 107 for long term storage of implementation code and data for servers and clients, and the like, an 
input device 109 and an output device 1 15 for receiving and outputting commands and data into the system 100, and 
an addressable memory 113 for storing server and client implementation code during execution by a processor 111. 
During execution by the processor 111. servers exist as processes in the addressable memory 1 13. Also coupled to the 
network 103 are a number of clients 105. Each client 105 is an object executing as a process in a remotely situated 
computer similar in structure to a host computer 101 , or alternatively, existing as separate processes in any of the host 
computers 101 . Each client 1 05 requests services or data from servers (not shown) in host computer s 101 on the net- 
work 103. The host computers 101 may be realized by most general purposes computers, such as a SPARCstation™' 
computer manufactured by Sun Microsystems, Inc. of Mountain View, Ca. Any other general purpose computer may 
also be adapted for use with the invention. Each host computer 101 executes a general purpose operating system, such 
as Sun Microsystems' Solaris® operating system. In addition, each host computer 101 is part of an object request bro- 
ker environment, satisfying the CORBA standards set by the Object Management Group in The Common Object 
Request Broker: Architecture and Specification, Rev. 1.2, OMG TC Document Number 93-12-43, available by anony- 
mous ftp to omg.org. Other equivalent environments for distributed object systems may also be used. In the preferred 
embodiment, the object request broker environment is Sun Microsystems' Project DOE (Distributed Objects Every- 
where). 

Referring now to Figure 2. there is shown a logical view of system 100. particularly illustrating the configuration of 
addressable memory 1 13 in any of the host computers 101 during runtime operation of various servers. The address- 
able memory 1 13 of each host computer 101 includes a number of executable objects for performing various functions, 
including user application functions, such as word processing, database management, graphics design, CAD engineer- 
ing, software development, financial management, and the like, and operating system functions, such as memory man- 
agement, resource allocation, storage management, and system accounting information, and network interfacing with 
remote clients and hosts. 

More particularly, host computer 101 includes a number of servers 201, each providing a particular type of func- 
tionality to clients 105 distributed on the network 103 (or locally executing in the host computer 101). Each server 201 
in the host computer 101 includes a number of objects 209. each of which encapsulates data associated with the object 
209 and its state, and executable code for implementing functional operations, or methods of the object 209 on the data 
or other objects 209. An object 209 is manipulated by clients 105 or other objects 209 through an interface definition 
that specifies the operaiions, attributes, and exceptions that an object 209 provides. The objects 209 are distributed 
objects, distinguished from conventional objects in object oriented programming languages in that the interface of an 
object 209 is defined in an interface definition language, which is then mapped to an implementation language, such as 
C+-I- or C. This allows objects 209 to have multiple implementations in various languages, while still maintaining a con- 
sistently defined interface. A client 105 does not have to have any information about the underfying Implementation of 
the object 209. but merely has to have the interface for the object 209. The objects 209 are distributed in that a client 
105 may invoke an object 209 existing anywhere on the network 103. including in the address space of a client 105. or 
any number of host computers 101. by using a naming server 227 and the various BOAs 225 on the host computers 
101. 

Facilitating communication the clients 105 and the host computers 101 is a basic object adapter 225. or BOA. The 
BOA 225 comforms to the requirements for the basic object adapter specified in CORBA. The BOA 225 provides an 
interface for clients 105 to access object implementations of objects 209 included in servers 201 on various host com- 
puters 101 distributed on network 103. Object implementations are actual code which implements an object 209. In 
order to efficiently manage the addressable memory 1 1 3 of the host computer 101 . the BOA 225 maintains records indi- 
cating which servers 201 are active and inactive, and in each server 201 , which objects 209 are active or inactive, and 
which implementations of object methods are also active or inactive. In this way the BOA 225 can readily manage mem- 
ory resources in the addressable memory 1 13 on an as-needed basis, allocating memory to active servers 201 . objects 
209 and implementations, and deallocating memory from inactive entities. The BOA 225 includes a daemon for man- 
aging and responding to invocations from clients 105 for objects 209 in the various servers 201 of the host computer 
101 . The daemon of the BOA 225 automatically starts up a server 201 in the host computer 101 to service an incoming 
call to an object 209 if the server 201 is not running. The BOA 225 receives a request from a client 105 for an object 
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209 in a server 201. the client 105 passing the object reference to the BOA 225, The BOA 225 determines whether 
there is an active implementation of the object 209 or method and if so. the BOA 225 passes the request to the object 
209, othenwise. the BOA 225 retrieves the implementation code for the object 209 from secondary storage 107, starts 
a new process for the invoked object, executing the implementation with the processor 1 1 1 . The BOA 225 will also man- 
age deactivation of objects 209 and implementations that are no longer being useb, or that are explicitly terminated by 
a client 105 or server 201. reclaiming resources allocated to the object 209 and updating any persistent attributes or 
data of the object 209. 

Coupled to the host computer 101 by the network 103 is a naming server 227. The naming server 227 maintains a 
name space directory 229 including number of naming contexts, each of which includes a set of name bindings. A name 
> binding is an association between an arbitrary object name, and an object reference uniquely identifying an object 209 
within a server 201 and further identifying the server 201 , and host computer 101 including the object 209. The naming 
server 227 provides methods for binding a name to an object reference so that the object 209 associated with the object 
reference can be accessed from the name, and for resolving names provided by clients 105 in order to provide an object 
reference to a client 105. With an object reference, a client 105 can directly invoke a server 201 or any object 209 within 
a server 201 . The naming server 227 provides clients 1 05 with a service that allows access to distributed servers 201 
before the client 105 has an object reference. Multiple naming servers 227 may be supported, with clients 105 trans- 
parently accessing various naming servers 27 on the network 103. In the preferred embodiment, a naming server 227 
is included in each host computer 101 . and supports objects 209 within the host computer 101 ; multiple naming servers 
227 then work in conjunction to provides clients 105 with object references for local objects 209. 

A factory object 21 1 may be associated with each object 209. for performing a single method that is called by a cli- 
ent 105 to create a new instance of the type of object 209. The factory object 21 1 is registered in the name space direc- 
tory 229 of the naming server 227. which is accessed by clients 105 for obtaining object references. Each factory object 
21 1 includes a static create member function that creates a new object 209 of the type specific to the factory object 21 1 
and returns an object reference to the new object 209. An initialize function is provided in created object 209 to perform 
any needed initialization on the object's state. Typically there is only one instance of a factory object 21 1 implementation 
for each object 209 in the server 201 . The instance of each factory object 21 1 is created when the server 20 1 is installed 
in the host computer 201 and registered in the naming server 227. An object 209 need not have an associated factory 
object 21 1 . for example, where the object 209 is not public and available only to the server 201 . or where the server 201 
IS designed to have a single instance of a particular type of object 209. 

For each server 201 on the host computer 101 there is a persistent server administrator 203 object that is instanti- 
ated from a server administrator class. Each server administrator 203 maintains configuration information for the par- 
ticular server 201 associated with the server administrator 203. including information that can be known whether or not 
the server 201 is executing. This allows system administrative tools to determine the state of the server 201 without 
having to start up the server 201 as a process in the host computer 101 . Throughout the remainder of this disclosure 
references to "the server" and "the server administrator" refer to one server 201 and its associated server administrator 
203. and It is understood that the functionality described for these respective entities applies to each respective server 
201 and server administrator 203 in the host computer 101. 

A server administrator 203 is created by a server administrator factory 205 when a server 201 is^installed on the 
host computer 101. A server 201 is installed using conventional installation techniques, such as executing the server 
201 using the name of the server 201 along with a -install command line argument. During this execution the server 
20 1 will create a new server administrator 203. Figure 3 shows a flowchart of one method by which a new server admin- 
istrator 203 is associated with a server 201. 

First, the server 201 is executed 301 during the installation process. The server 201 searches 303 for an existing 
server administrator 203 object by accessing the naming server 227 for the host computer 1 0 1 . and traversing the name 
space directory 229. The server 201 determines 305 whether a server administrator 203 object exists with the appro- 
priate name. If no associated server administrator 203 object is located in the host computer 101 the server 201 
accesses 307 the server administrator factory 205 via an object reference stored in the naming server 227 

The server 20 1 will invoke 309 the create method of the server administrator factory 205. instantiating a new server 
administrator 203 object, and obtaining an object reference for the new sen/er administrator 203. The server 201 will 
then store 31 1 a binding of the object reference and an object name for the server administrator 203 in the naming 
server 227; the object name should uniquely Identify the server administrator 203 as associated with the particular 
server 201 . Typically the ot^ect name will have the following format: 

(host_computer_name)/admin/servers/{server_name) 
where host_computer_name is the literal string name provided to the host computer 101 including the server 201 and 
the server_name is specified by the developer of the server 201 , 

The sen/er 201 will set 313 various execution related configuration information in the appropriate structures of the 
server administrator 203. as further described below. This information preferably includes the name of the host compu- 
ter 101 where the server 201 is installed, the name of the server 201 and any aliases for executing multiple instances 
ot the server 201. the path name of any data directory the server 201 uses for storing and accessing local data and 
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resources, and the program definition. The data directory information allows the operating system or other administra- 
tive layer to administer the files in the data directory, for example, providing backup services. The data directory is used 
to issue a change directory command after the server 201 is executed so that the identified directory becomes the cur- 
rent directory. The saved program definition is the pathname, command line arguments, and environmental variables 
used when the server 201 is started up. 

Normally, the program definition is stored in the BOA 225 as a part of the execution definition. In the BOA 225 any 
change to the program definition is permanent and undoable. and thus previous configurations of the program definition 
are not saved. However, it is typically necessary to alter the program definition for administrative reasons for example 
to attach a debugger to the server 201 for debugging, or to execute various functions from a shell program Convention- 
ally, once the program definition in the BOA 225 is made to accommodate these needs, the system administrator would 
have to manually reconstruct and reset the normal or original program definition. With the saved program definition 
stored in the server administrator 203 this information can be preserved and recalled separately from the BOA 225 The 
saved program definition thus allows the server administrator 203 to restore the correct program definition after the BOA 
225 has been changed. 

'5 Once the basic server information is stored in the server administrator 203. the server 201 will loop 315 over each 
of the implementations present in the server 201 . Each implementation is executable code that implements an interface 
or methods or attributes of an object 209 included in the server 201 . The server 201 tests 31 7 whether the interface of 
the implementation is already stored in the server administrator 203. and if not, the server 201 stores 319 to the server 
administrator 203 information to identify the interface. This information preferably includes an identificatfon of the inter- 
face, such as the name of the interface and an identification value. This information allows the server administrator 203 
to provide to clients 105 information as to which objects 209 the server 201 supports. The server 201 then stores 321 
in the server adm nistrator 203 information about the implementation, preferably storing the name of the implementa- 
t"* implementatfon that is unique on the host computer 101. and the interface asso- 
ciated with the interface. This allows the server administrator 203 to invoke the implementation at a later time in 
response to a request from a client 1 05, thereby starting up the server 201 if necessary. 

The purpose of this loop is to identify to the server administrator 203 which object interfaces the server 201 imple- 
ments, so that the server administrator 203 can provide this information to client 105 at a later time without having to 
?nt?l^.l "l"'!' I/. " '"""'"^ '""^ irrformation. In addition, this internal 

o " '"'''^ '^"""'^ "^"^ °' opacity of the distributi 

ob,e« programming environment, allows clients 105, acting on behalf of system administratorTor others, to deterr^^ 
which servers 20 1 are capable for performing which functions. aeiermine 
The server administrator 203 provides clients 105 with a unified means for accessing and manipulating confioura- 
^on information about the server 201 with which it is associated. Figure 4a illustrates a dataflow diagram ofThe S 
arch^ecture of obtaining and manipulating configuration information. Generally the server administrator 203 receives 

informat^n about he server 201. The server administrator 203 will execute 403(a.b) the appropriate method as 

More particularly the server administrator 203 may invoke 403a a method to return 405 the requested conf iouration 

stnra r '""T: ^^'"'^ ^^'""'"^ '^^^ information by acceSg ^o S 

structures 411 in the sen/er administrator 203 that persistently maintain the configuration information- by accS^ 
405b configuration information stored in the BOA 225; and by accessing 405c the server 20lTser 

The server adminstrator 203 may also execute 403b methods to update 407 configuration information usino values 

^t^!S"V, persistently stored configuration information in the BOA 225 or similar services: and updating 407c 
stored configuration information in the server 201 . ufjudung ^u/c 

nll^ '"Stances, the server administrator 203 may also invoke 409 other objects 209 or sen/ices in the distributed 
object environment to obtain the requested configuration information aistributed 

nhi.r/na T 7"^ administrator 203 accesses the stored configuration information 411. the BOA 225 or other 
object 209, It performs its functionality without invoking the server 201 if the server 201 is not already exSrtna as a 

ru::ts'a d'sim?r"T" ™' ^"^^"^^ resp^t tlT2 105 

requests, and simplifies administration of the system 100 

ess idemStL" «^ '° ^i?^^' ^^^^ ^^'"^"^'^ configuration information, such as the proc- 

ess Identifier o the server 201 , there is preferably an object 209 within the server 201 that can observe and reoort th*. 
currem state of the server 201 . Because the server administrator 203 is not within the se7vr201 w^whteh T^^^^^^^ 
slmeS/oo r '° administrator 203 alwayrhas acce^^^^^^ 

!mbLd^ n H ' '^^^"^'"^^ °' applications developer created the server 201 , there is ?eferably 

related application identrfied above. The server spy 21 3 is known by the server administrator to always be present, and 
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accordingly, the server administrator 203 calls the server spy 213 to obtain dynamic configuration information about the 
server 201 containing the server spy 213. The server spy 213. as with all objects 209. inherits from a base class. 
CORBA::Object, that provides several fundamental functions. One of these is the Jmplementation method. This 
method returns a CORBA pseudo object specific to a CORBA defined implementation class. This class provides further 
basic functionality, particularly, methods that return information about the process in which the originating object, here 
the server spy 213. is embedded. This information is passed back to the server administrator 203 as necessary to pro- 
vide the desired information to a requesting client 105. 

Figure 4b illustrates the general architecture of this interaction between the server administrator 203 and the server 
spy 213. First, a client 105 will invoke 401 a method of server administrator 203 to provide some specific information 
> about the current state of dynamic configuration information of the server 201 . The server administrator 203 will invoke 
415a the server spy 213 to obtain the information. In some cases, the server spy 213 has the necessary method to 
obtain the information, and so executes and returns 417a this information to the server administrator 203. In other 
cases, where the server spy 213 does not include an appropriate method itself, server administrator 203 will then invoke 
415b the Jmplementation method of the server spy 213. The Jmplementation method is inherited from the 
CORBA::Object class, and returns 417b an object reference to a CORBA pseudo object 419. This CORBA pseudo 
object 419 has all the functionality defined by the CORBA standard for the object base class. The server administrator 
203 will then invoke 415c an appropriate function call on the CORBA pseudo object 419 to obtain the requested infor- 
mation about the server 201 . The CORBA pseudo object 419 will return 41 7c this information to the server administra- 
tor 203. which may store it 407 or pass H 41 3 on to the client 1 05 If desired. In other cases, the server administrator 203 
will invoke 415a a particular method of the server spy 213. which will In tum invoke or access 423 a lower level object 
or process, such as the operating system 421 or the BOA 225 to obtain the requested information. 

This architecture has been shown with respect to the preferred embodiment using the server spy 213. The server 
spy 213 is the preferred object 209 for this process because It is embedded in every server 201 created in the distrib- 
uted object programming environment, and thus, the server administrator 203 can reliably invoke the server spy 213 in 
the server 201 . Alternatively, any object 209 In the server 201 can be employed in the same capacity as the server spy 
213. so long as that object 209 inherits from the C0RBA::Object class. To do this, the server administrator 203 would 
have to identify the objects 209 In the server 201 . in a manner similar to that described with respect to Figure 3 The 
server administrator 203 could then select one of the identified objects 209 as its agent for performing these various 
methods as required. 

The specific methods or attributes provided in the preferred embodiment of the server administrator 203 for deter- 
mining various types of configuration information of the server 201 are as follows, and are one implementation of the 
interface definition included in Appendix A. Appendix A is a pseudo interface definition language (IDL) file Illustrating 
one embodiment of the interface of the server administrator 203: the following discussion is with respect to the function- 
ality of a server administrator 203 described above, as provided by the interface disclosed in Appendix A. It is under- 
stood that other interface definition files may also be suitably used to define a server administrator 203 object Similarly 
various implementation files can be used to implement the attributes of the server administrator 203 (further described 
below) as shown in IDL file. 

The server administrator 203 includes an attribute for determining whether the server 201 is currently expcuting as 
a process in the processor 1 1 1 of the host computer 101 . An example of^the interlace for this attribute is the is.running 
attribute of the IDL. This boolean attribute Indicates whether the server 201 associated with the particular server admin- 
istrator 203 IS currently executing as a process by the processor 1 11 of the host computer 101 . When this attribute is 
invoked, the server administrator 203 calls 41 5b the Jmplementation method of the server spy 21 3. as illustrated In Fig- 
ure 4b. which returns 41 7b an object reference to a CORBA pseudo object 419. 

The server administrator 203 then invokes 415c an is.server.running method on the CORBA pseudo object 419 
which IS provided as part of the implementation object class for CORBA. This method operates by determining whether 
the implementation that includes the CORBA pseudo object 419 is currently executing. The CORBA pseudo object 419 
will return 417c a boolean TRUE if the server 201 is running, othen^^lse. It returns 417c a boolean FALSE With this 
method, the server administrator 203 Is able to determine, on behalf of a request from a client 105. whether a server 
201 IS actually running without starting up the server 201 since a call to the CORBA pseudo object 419 may be com- 
pleted without starting up the server 201 . as with a normal distributed object 209. 

The server administrator 203 further Includes an attribute for determining the process Identifier of the server 201 
An example of the interface for this attribute Is the processjd attribute of the IDL This attribute is implemented by 
method similar to the Is.running attribute. Here, after obtaining 41 7b the object reference to the CORBA pseudo object 
419. the server administrator 203 will invoke 41 5c a processjd method on the CORBA pseudo object 419 This method 
returns 417c the process identifier for the process, here the server 201 process, that contains the CORBA pseudo 
Object 419. If the server 201 is not running as a process, the CORBA pseudo object 419 will return zero. Again, this 
method allows the server administrator 203 to provide internal state information, here the process id. of a server 201 to 
a client 105 without starting up the server 201 . 
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The server administrator 203 further includes an attribute which wiW suppress the server 201 from starting up to 
service '"vocations of object 209 within the server 201 . An example of the interface for this attribute is the hold down 
attribute of the IDL. As noted, the daemon of the BOA 225 automatically starts up an inactive server 201 in the host 
coriiputer 101 to sen^ice an incoming call to an object 209. However, it is sometimes desirable to suppress the server 
201 . for example, to upgrade, or backup the server 201 . In these instances, the system administrator or other user does 
not want the daemon to start up the server 201 in response to calls from clients 105. Accordingly, the daemon will 
always check a hold_down value set in the execution definition of the server 201. as stored in the BOA 225 The 
hoW.down attribute (in both the server administrator 203 and in the BOA 225) is preferably a multivalued enumerated 
type, providing for various types of hold_down responses. The hokJ.down attribute may have a "LONG" value which 
indicates to the daemon that the server 201 will be down for an extended period time. In this case the daemon can 
throw an appropriate exception back to the invoking client 105. The hold.down attribute may have a "SHORF value 
*® ^^T' temporarily, such as several seconds, in which instance the daemon will 

wart until the server 201 is available again, and then service the client 105 by starling up the server 201 Finally the 
hold.down attribute may take a "NONE" value, indicating that the server 201 is not held down, and immediately availa- 

terlZ 20^^L^%VZ% '"^^ Attribute by finding the execution definition for the 

sender 201 in the BOA 225. obtaining the program definition included in the execution definition, and setting the 

noid_down value in this definition, =»cu"iy uic 

l!iSt?nn nH J .H ^ 1 ^ '"^^'^^'^ '^'^ ^^^'^"^^ boa_program_def attribute of the IDL This program 
definrtK)n 'ncludes the pathname, command line arguments, and the environment to be used when the server 201 is 
tarted up by the BOA 225. This attribute of server administrator 203 allows a client 105 to change the pro-am def in 
tion at any time, again, without having to start up the server 201 merely for this purposes, and without havino to dJtctIv 
2TZTcZ!2^T- " '""'"^ boa^rogram.def attrL^and passing in t deSid pa am- 

Whln h f • 2^ "T^"" 225 the next time the server 201 is invoked 

When this attribute is invoked without parameteis. the server administrator 203 will return the current program dS 

BOA^JjfAT' administrator 203 further includes an attribute that stores a backup version of the program definition in 
aboveihe BOaI?? ^ ? the jnteHace for this attribute is the savedj:rogram_def attribute of ttie IDL. As des^SJS 
S minlilf only maintains a single current program definition, which may be changed only temporarily f7r 

administrative purposes. The saved program definition allows changes to the program definition to be reS^to a ore 
vious version; this is particularly useful for temporary changes to the program definition. Invoking ?4 aSe return^^ 
the current saved program definition stored in the server administrator 203. The save prooram de^n^tonl u^«t^ 
manually by the server 201 bypassing in the program definition when the server 201 Is iSS^ ^ 

The server administrator 203 further includes an attribute that restores the program definition in the BOA 225 with 
the saved program definition of the server administrator 203. An example of the irterfre for th s attr?bu,e kThp 
restore saved j^rogram attribute of the IDL. When invoked, the server administrator 203 wSl^^^^^^^^^ proSm defW 

sJnX BOA r ''VI r ' "'"^^ ''^^ definition^S^b^trStdS^^^^ 
by accessing the BOA 225 using an object key provided by an object key method included in all CORBA obiects such 
as he server spy 213. The object key is then used to extract an object definition, which in tu n i^usil tf ob ain an 

the ser^t 2m ' . °u ^"^=«"«'"9 f««^"ame and argument list of the desired application for 

the server 201 . This is one way m which the program definition of the BOA 225 may be changed as de^ribS abovJ 
:Tj:SZ203l^:;^^^^^^ savedj,rogram_def attributes. Using the interisfattLte oTf^^ 

upThe se^er 201 administrator to alter the configuration information of the server 201 without starting 

I. inS;L"ln?°^ ?K "^'^'"^"""S the interpose attribute is shown in the flowchart of Figure 5. The interpose mettiod 

onTbt exiulLi 'TJf T "'^^ P^*''--^ °' the inte^Sg ap^S 

Swa ns^r,S I ; ^ ^^S"'^^"^ t° be passed at the command line. The server administrator 203 

obtains 503 the existing program definition of the server 201 from thp ROA nnH ^h=„„»,. c«c .1 ''""""'^^'^'^'^ ^^"^ 
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application, instead of as a regular argument, so that the actual following arguments can be identified; setting S1 1 the 
second argument to the actual pathname of the server 201 ; appending 513 the original arguments of the program def- 
inition for the server 201; and finally, appending 515 the additional arguments that were passed into the interpose 
method for controlling the execution of the interposing application. The server administrator 203 will then store 51 7 the 
new program definition in the execution definition of the server 201 in the BOA 225. 

The server administrator 203 further includes an attrilxjte for storing and setting the configuration of the reaper 21 7 
for performing automatic deallocation of resources held by idle objects 209. An exanple of the interface for this attribute 
is the reaper_conf ig attribute of the IDL. The reaper 21 7 is preferably configured by three values, a server timeout value, 
a cycle time value, and a boolean flag. The reaper cycle tme determines how often the reaper 21 7 is activated to per- 
form automatic deallocation. The server timeout value establishes maximum time interval which the server 201 may be 
idle, that is. during which no object 209 within the server 201 is invoked. If this time interval is 

equaled or exceeded, then the reaper 217 will automatically shutdown the server 201 the next time the reaper 
217 IS active. The boolean flag, reaping, tells the reaper 217 whether or not to perform automatic deallocation The 
method of the reaper 217 is further shown in the related application identified above. In the preferred embodiment 
these vanous values are stored persistently in the server administrator 203, and when a server 201 is invoked, the 
reaper 217 included in the server 201 reads the reaper configuration attribute of the server administrator 203 associ- 
ated with the invoked server 201 . and sets its values accordingly. 

The server administrator 203 further includes an attribute for storing and setting the configuration of the logging 
configuration of the server 201 . An example of the interface for this attribute is the LoggingConfiguration attribute of the 
IDL. The logging configuration attribute includes a boolean flag to indicate whether tracing and similar output informa- 
tion IS handled by the operating system s system logging daemon; another boolean flag to indicate whether such infor- 
mation IS to be output to the console, and a structure identifying a user specified log file for outputting this tracing 
information, a number of swap log files, and a maximum file size for the tog files. The manipulation of log files is further 
described in the related application referenced above. In the preferred embodiment, these various values are stored 
persistently in the server administrator 203, and when a server 201 is invoked, the logging API 221 of the server 201 is 
configured according to the logging configuration of the server administrator 203. 

The server administrator 203 further includes an attribute that maintains various internal event driven state varia- 
bles for the current process of the server 201. An example of the interface for this attribute is the startingQ method of 
the IDL file. In the preferred embodiment, these internal state variables are used to monitor whether the server 201 is 
currently running, thereby allowing the server administrator 203 to report on the current status of the server 201 without 
starting up the server 201 if it is not already running. These internal state variables include the process identifier for the 
server 201 process, and a heartbeat interval value indicating how often the server 201 sends a signal a heartbeat to 
Its server administrator 203 indicating that it is still active. This heartbeat signal is preferably used instead of the server 
administrator 203 polling the server 201 to determine whether it is active. The internal state variables further include a 
value indicating a maximum number of heartbeat signals the server 201 can fail to pass to the server administrator 203 
before being presumed to have crashed. Invoking the starting attribute of the server administrator 203 will cause the 
server 201 to update the attribute values. In the preferred embodiment, the process identifier is provided by the server 
spy 213, which indirectly invokes a getjydO on the server 201 process. 

Each time the server 201 sends a heartbeat signal, the server administrator 203 timestamps the signal The server 
administrator 203 periodically according to the heartbeat interval value, and determines if the server 201 has missed a 
heartbeat, whereon the server administrator 203 increments a counter. When the counter reaches the maximum value 
set for missed heartbeats, the server administrator 203 begins a thread to check whether the server 201 has been shut- 
down or otherwise been terminated. 

In conjunction with the starting method, the server administrator 203 also includes a method that is invoked in 
response to a received heartbeat from the server 201. An example of the interface for this method is the 
send,ng_heartbeat() method of the IDL file. When the server 201 sends a heartbeat, the server administrator 203 
resets a stored timestamp value that tracks the time of the last heartbeat. If the server administrator 203 itself has 
recently been terminated or shutdown, then it may not have any information as to the identity of the server 201 sendino 
he heartbeat signal; in this case, the server administrator 203 will return a FALSE signal to the server 201 which in 
turn will invoke the starting() method of the server administrator 203. If the server administrator 203 has been active 
and does have current information on the identity of the server 201 it is associated with, then it return a TRUE siqnal to 
the server 20 1 . indicating that the heartbeat has been successfully received. 

Finally, the server administrator 203 also includes an method that is used to indicate that the server 201 has been 
shutdown. An example of the interface of this method is the stoppingQ method of the IDL file. When the server 201 is 
Shutdown through the shutdown method of the server spy 213, the stopping() method is invoked. This updates the inter- 
nal state vanaWes of the sen/er administrator 203 to indicate that the server 201 is no tonger active 

. J! '^rif'"'"'^? ^ ""'"''^^ °' configuring the tracing facilities included in 

a server 201 . A tracing facility is a set of trace flags that control tracing of selected events, and a set of output values 
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that are output wfien the various traced events are executed. Tracing facilities and their use are described in further 
detail in the related application. 

A trace configuration is a set of tracing facilities. The server administrator 203 can store a number of tracing con- 
figurations that can be used with the sender 20 1 to provide for conditional output of tradng infbr 
201 IS started up. it reads the tracing configuration information in the sen/er administrator 203 and selects a distin- 
guished tracing configuration for initial use; this tracing configuration Is named "startup." The server administrator 203 
can later change the setup for available tracing configurations, by selecting configurations that provide different sets of 
trace faclrt.es. or enabling or disabling various trace flags in selected trace facilities. This process does not change the 
actualfacilrt^ m the server 201. but only the settings of the facilities that will be used if and when the fadlit^ i?!ater 
enabled in the server 201 . The server spy 213 is used to enable or disable the tracing facilities in the server 201 

More specrfically. the sen/er administrator 203 includes various methods for determining and changing tracing con- 
■gurations. A f^d method allows a user, such as a system administrator operating through a client 105 to loS Z 

fo^ T^7n^2TT *° "^^"^'"^ " ^"^^ = '^'^"'^ P^«=«"t administrator 

203. If the named configuration is not present, the server administrator 203 returns an appropriate exception 

2fli Tn SI T ^1°^ ^ T^"" administrator to add a new, empty configuration with a specified name to a server 
201, to be later completed with speafied facilities. When invoked, server administrator 203 will search for the named 
etl'l T.rj °' cx^nfigurations. If the configuration is found, the server adminisfrator 203 w^ 

return an exception indicating rts existence. othen/.ise, the server administrator 203 will create a new configuration A 
remove method allows a system administrator to remove a named configuration from the stored sequeTe o^Su 

The server administrator 203 also includes a metiiod for enabling specific trace flags in a trace fadWy in a conf ia- 
."dm,? J? " ' "^-^^^ « 'aciiity name, and the desired flags to be enS ThetTX 

administrator 203 will search through its stored sequence of configurations. If the named conf igura^^on is foLr^Te 
server administrator 203 will search through the configuration for the named facility, and if th^fadS? s induS H 

nS'fr. fT ^'r""''''' ^"^'^ T'^^ server'administrator 203 wi I retur^Co 

mZLTr H- ^°'^'9"^««o" 0^ fedlity is not located. Similarly, the server administrator 203inZes a 

fir. w?L ^ T^f " "'"^ ^^^'^^ configuration and trace facility Examples of tJ^e inter 

faces for the add. find, remove, enable and disable methods are shown in the IDL file 

The server spy 213 includes methods for altering the runtime operation of tracing facilities in the server 201 

flnr« ."""7 °' '''''' ♦^^='"9 ♦^^""'^^ '^'-^ ad^ni .rati" 203 mTy depart 

from those operating ,n the server 201 , with new facilities added, or old ones deleted in the server administrator 203 
The server administrator 203 thus indudes a method for updating the server 201 to include the c™7sL^^^^^^^^ 
facilities in the server administrator 203. by deleting from the server 201 tracing fadlities that are nTcurri^^^^^^^^ 

able .n the server 201 An example of interface for this method, setjacilities. is shown in the IDL file 

Figure 6 is a flowchart of one embodiment of the logic of a method for updating the facilities of the server 201 m 
h^ embodiment, the method loops 601 over each of the fadlities in the server adm r^^sfraS S and fo eacMac lity 
loops 603 over the facilities in the server 201 . If none of the fadlities in the server 201 match 605 the facilrtv in t^ol 11; 
tnZT°' 203, then the fadlity is added 607 to the server 201. This part of the memc^i u^e^^^^^^^ 
include any new facilities defined in the server administrator 203. Second the method Ioods 609 ovir larh J^r 2 

«y7s';?sent"n'tr'^'".^''"''^*"'^"""^^'''"'"'^^^^^^^ 

ity IS presentin the server administrator 203. If not. then the facility is no longer required and it is deletS 6^5 from thL 

^ • H'uvaea oy eacn server 201, and a column 709 for the process identifer of each <;pr\/Ar « ih^ 
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shown in column 709. this server 201 is not currently executing. Other servers are active, such as the 
Warehouse_server 715. and the process identifier is the same for all its implementations. The window 701 allows a 
user, such as a system administrator to filter the listing, using either a host computer name in text entry field 717 or a 
server name in text entry field 719. or both. As can be seen by the listing, servers 201 can be identified in host comput- 
ers 101 without starting them up. as indicated by the "inactive" notation for the process identifier. 



APPENDTX A 

// File: ServerAdmin. idl 
// 

// © 1994 Sun Microsystems, Inc. 
// 

#ifndef _SERVER_ADMIN_IDL 
tfdefine _SER\/'ER_ACMIH_IDL 

// ^pragma idenc -@ ( #) ServerAdmin . idl 1.13 S5/01/16 Sun Microsystems - 
# include "ServerSpy . idl" 



// 



// Each CD? server has a ServerAdmin object associated with it that 
// has static information about a server, that is, everything that 
// can be known without the server process running. 

// 

// It also ir^lements the ServerSpy interface, which includes calls to 
// inspect and change the state of the running server. 



module DatFxc { 

// interface. The interface ID is the logical ID used in the interface 

// repository, 
s-ruct Interface { 

string interface^narr^e; 

string interf ace_id; 

); 

typedef sequence<Interface> Interfaces; 

// ImplGmentation of an interface. The iclass.id is the internal 
// identifier of the implementation, unique on the host, 
scruct Implementation { 

Interface implemented_interface; 

string implementation_najne; 

BGA: : Iclassid iclass_id; 

Datint: : Seconds reaper_timeout ; 
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typedef sequence<Implementation> Implementations ; 

//An implemented interface, 
struct Implementedlnterface ( 

Inter face implemented_inter face ; 

Implementations implementations; 

}; 

typedef sequence<lroplementedlnterf ace> Implementedlnterfaces; 

// Named tracing configurations. There is always a configuration named 

// "startup" which is read by the server when it starts. 

//To change the current tracing without saving anything permanently, 

// use the calls inherited from ServerSpy which operate directly on the 

// running server process. 

struct TraceConfig ( 

string conf ig.name; // Config's name 

Datint: : Facilities facilities; // Facilities and their flags 

); 

typedef sequence<TraceConf ig> TraceConf igs; 

interface TraceConf igList { 
exception ConfigExists {}; 
exception UnJcnownConf ig {}; 

exception Predef inedConf ig {); // Trying to remove "startup", etc. 

void add( 

in string config_nanie 
) raises (ConfigExists ) ; 

void remove ( 

in string config_name 
) raises (UnknownConfig, Predef inedConf ig) ; 

TraceConfig find( 

in string config_name 
1 raises ( UnknownConf ig ) ; 

void use( // Use this config for current tracing 
in string config_name 
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) raises (UnknownConfig) ; 

void enable_flag( 

in scring conf ig_nanie, 
in string facilicy_naine, 
in string flag 
) raises (UnknownCon fig, 

Datint: :ServerSpy: : UnknownFacility, 
Datint: rServerSpy: :UnknownTraceFlag) ; 

void disable_flag( 

in string conf ig_naine. 
in string facility_najne, 
in string flag 
) raises (UnknownCon fig, 

Datint: :ServerSpy: : UnknownFacility, 
Datint: rServerSpy: :UnknownTr ace Flag) ; 

boolean f lag_is_enabled ( 
in string conf ig^name , 
in string facility_naitie, 
in string flag 
} raises (UnknownConfig, 

Datint: :ServerSpy: : UnknownFacility, 
Datint : : ServerSpy : : UnknownTraceFlag) ; 

readonly attribute TraceCcnfigs trace_confi 

// These two are for internal use only, 
void set_facilities ( 

in Datint :: Facilities facilities 

) ; 



void destroy! ) ; 

); // TraceConfigList interface 



// Startup logging configuration. 

struct LoggingConf ig { 

boolean send. to.sys log; // Send output to syslog daemon 
boolean send.to.console; // Send output to console (ie s 
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Daclnc: :LogFile log^file; // Send output to this file 

}; 

// Startup reaper configuration. Each implmentation • s reaper timeout 

// is set at startup from the corresponding Implementation 

// structure. 

struct ReaperConfig ( 

// How many seconds to wait after the last object invocation 

Datint: : Seconds server_timeout ; 

// How often to wake up the reaper thread and check timeouts 
Datint: : Seconds reaper_cycle_time; 
// Whether reaper should be started 
boolean reaping; 

}; 



// 

// 

// InternalAdmin interface 
// 

// These are the methods that should only be called from within ODF. 

// 

// * ^.^^ ^ 

interface InternalAdmin { 
void set_server_name( 

in string server_name 

) ; 

void set,.version ( 

in Datint: : Version version 

) ; 

void set_data_directory( 

in string data_directory 

) ; 

void s et_compute rename ( 

in string computer_name 

) ; 

void set__development_mode{ 

in boolean in_devGlopm€nt 

) ; 
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45 



50 



// 

// Populate the interface/ implementation sequences: called by 
// servers at registration time 

// 

exception InterfaceExists (); 
exception Inter faceNotFound {); 
exception ImplementationExists (); 
exception Imp lementationNot Found {); 

// Called at the start of the registration run 
void clear.interf aces ( ) ; 

Interface f ind.interface ( 

in string inter face_name 
) raises ( Interf aceNotFound) ; 

void add_interface( 

in Interface new_interface 
) raises { InterfaceExists ) ; 

void c lea r.implemen tat ions ( ) ; 

Implementation f ind_implementation ( 

in string inter face.name, 

in string implementation.name 
) raises (InterfaceNotFound, Inplementa tionNot Found ) ; 

void add_implementation( 

in Implementation implementation 
) raises (ImplementationExists, InterfaceNotFound) ; 

void set_spy( 

in Datint : rServerSpy spy 

); 

); // InternalAdmin interface 



// 

// ServerAdmin interface 

// 



55 
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// * 

interface ServerAdmin: IncernalAdmin, Datint : :ServerSpy ( 

// 

// Attributes set at server registration time 

// 



// ODF servers automatically set this information. 

readonly attribute string server.name; // Server name 

readonly attribute Datint :: Version version; // Server version and date 

readonly attribute string data.directory; // Persistence directory 

readonly attribute string computer.name; // where installed 

readonly attribute boolean in_development ; // Versus deployed 

readonly attribute Interfaces interfaces; 

readonly attribute Implementations implementations; 

readonly attribute Imp lementedlnter faces implemented.inter faces; 

// 

// Inspect /change the current server state (also see the ServerSpy 
// interface) 

// 



//Is the server currently running? 
readonly attribute boolean is.running; 

// Process ID if running, zero otherwise 

readonly attribute Donf Adminisl rat ion : : pid_t process.id; 

// Prevent or allow new requests from starting the server. 
// HoldDownDuration meanings: 

// LONG: Future reqfuests throw an exception 

// SHORT: Future requests wait for server to be released 

// NONE: No hold is in effect 

attribute Boa Db Admin :: HoldDownDuration hold.down; 

// Program definition that controls how the domf daemon starts the 
// server. 

attribute BOA::Program boa_prograrr._def ; 
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// Saved version of server startup parameters in the BOA database, 
attribute BOA :: Program saved_program„def ; 

// Set the current BOA program definition to the saved definition, 
void restore_saved_program( ) ; 

// Interpose another program before the server, Programj>ath will 
// become the pathname, argv(lj becomes "-.orig.prog.path- . 
// argv[21 becomes the original path, and the rest of the arguments 
// are appended. When the domfd starts the server it puts its 'own 
// arguments first, so the interposing program must search for the 
// --.origjjrog^path- switch to find the server program path, 
const string interposed.arg.identif ier = " -.orig^rogjjath" ; 
void interpose { 

in string alternate_j)rogram_path, 

in BoaDbAdmin: :BoaDb: :StringSeq additional^args 

) ; 



// 

// Configurations read by servers at startup time 

// 

readonly attribute TraceConf igList trace.conf ig.list ; 
attribute ReaperConfig reaper_conf ig; 
attribute LoggingConf ig logging_conf ig; 

// 

// Methods called by servers to notify ServerAdmin of state changes 

// 



// Called by servers when starting 
oneway void starting ( 

in DomfAdministration: :pid_t pid, 

in Datint: : Seconds heartbeat_interval_seconds . 

in unsigned long inissed_heartbeats_al lowed 

); 

// Called by servers periodically 
boolean sending_heartbeat ( ) ; 
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// Called by servers when shutting down 
oneway void stoppingO; 



// 

// Other methods 

// 

// The spy objref. Any calls to this will start the server if it is 
// not already running. 

readonly attribute Da t Int :: Server Spy spy; 

// Destroy the instance and free its persistent state, 
void destroyO ; 

// This interface's version 

readonly attribute Version admin_interface_version; 
}; // ServerAdmin interface 



in 
// 



// ServerAdminFactory: Create a new ServerAdmin instance 

// 



interface ServerAdminFactory ( 



ServerAdmin create(); 



#endif // _SERVER_ADMIN_IDL 



Claims 



1 . A computer system for accessing and manipulating configuration information about a server without starting up the 
server as a process, comprising: 



18 



10 



EP0 732 834 A2 

at least one persistent server administrator object associated with the server, and stored externally to the 
server, and including: 

a plurality of machine readable storage structures adapted to contain configuration information of the server; 
a plurality of machine executable structures adapted to access and manipulate the machine readable storage 
structures, the machine readable storage structures updated to include selected configuration information dur- 
ing registration of the server. 

2. The computer system of claim 1 further comprising: 

at least one client object executing as a client process; 
wherein the server administrator object is adapted to receive invocations of the machine executable struc- 
tures from a client object, and in response to the invocations, to provide selected configuration information to the 
client object. 

15 3. The computer system of claim 1 further comprising: 

at least one client object executing as a client process; and 

a basic object adapter communicatively coupled between the client object and the server and adapted to 
prov.de the client object access to objects within the server, the basic object adapter further adapted to store exe- 
cution configuration information of the server to invoke the server in response to a request from the client object- 
wherein the server administrator object is adapted to receive invocations of the machine executable struc- 
tures from a client object, and in response to the invocations, to update the execution configuration information of 
the server stored in a basic object adapter. 
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4. The computer system of one of claims 1 to 3. further comprising- 

25 

a primary storage adapted to store the server as a server process including objects and data- and 

a processing unit adapted to execute a server and object methods, each executed server or object method 

being a process in the primary storage; 

30 5. The computer system of claim 4. wherein selected ones of the structures of the server administrator object further 

comprise: 

a process identification structure adapted to determine a process identifier of the server executing as a process 
by the processing unit without invoking the server if the server is not currently executing and 
■■^ a structure adapted to store the process identifier. 

6. The computer system of claim 1 . wherein selected ones of the structures of the server administrator object further 

comprise. 

^0 a name structure adapted to determine a name for the server, and a structure adapted to store the name- 

a host name structure adapted to determine a computer name of the host computer including the associated 
server, and a structure adapted to store the computer name; and 

an execution definition structure adapted to determine an execution definition structure containing at least a 
current pathname for the server, and a structure adapted to store the execution definition. 

45 

7. The computer system of claim 6. wherein the execution definition structure is further adapted to establish a current 
rZ^'^l ^ """"^"^ °' command line arguments and a current set of environment parameters 

l„r,m H J J ^^''^ ^"^ *^ ""Pl^* <° « Structure adapted to store the current 

program oeTinition. 

50 

8. The computer system of claim 7. wherein selected ones of the structures of the server administrator object further 
comprise. 

S5 H^^L"'^"'^? ^'"^ !°u ^ server, the saved program definition including a 

backup pathname of the server, a backup set of command line arguments, and a backup set of environment 

parameters; and. 

a structure adapted to restore the current program definition with the saved program definition. 
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9. The computer system of claim 6. wherein the execution definition structure is further adapted to determine a 
pathname of a data directory associated with the server. 

10. The connputer system of claim 1 . wherein selected ones of the structures of the server administrator object further 
comprise: 

a structure adapted to determine whether the server associated with the server administrator is executing as 

a process without invoking the server if the server is not currently executing: and. 

a structure adapted to store a boolean value indicative of whether the server is executing. 

1 1 . The computer system of claim 1 . wherein selected ones of the structures of the server administrator object further 
comprise: 

a structure adapted to establish a hold down value in an execution definition of the server used to invoke the 
server; and. 

a structure adapted to store the hold down value, 

12. The computer system of claim 1 . wherein the machine executable structures of the server administrator object fur- 
ther comprise: 

a structure adapted to interpose an executable application for the server when the server is invoked: and. 
a structure adapted to store a program definition for the executable application, including a pathname for the 
executable application, and a set of command line arguments. 

1 3. The computer system of claim 1 . wherein: 

the server further includes a machine executable deallocation structure adapted to automatically deallocate 
idle objects within the server when the server is executing as a process, the machine executable deallocation struc- 
ture operating according to selected ones of the machine readable storage structures in the server administrator 
object; 

wherein the selected ones of the machine readable storage structures include: 

a first attribute that enables or disables the machine executable deallocation structure; 

a second attribute that establishes a cycle time for the machine executable deallocation structure; and. 

a third attribute that establishes an maximum time interval for which the server can be idle, such that the server 

is automatically shutdown by machine executable deallocation structure after a time interval equal to or 

exceeding the maximum time interval; 

and wherein selected ones of the machine executable structures of the server administrator object esteblish 
selected ones of the first, second, and third attributes. 

14. The computer system of claim 1 . wherein: 

the computer system includes a machine executable logging structure adapted to log information regarding 
the execution of the server, the machine executable logging structure operating according to selected ones of the 
machine readable storage structures in the server administrator object: 

wherein the selected ones of the machine readable storage structures include: 

a first attribute that enables or disables logging by an operating system process: and 

a second attribute that identifies at least one log file used by the machine executable logging structure to store 

information, and that establishes a maximum file size for the log file; 

and wherein selected ones of the machine executable structures of the server administrator object establish 
selected ones of the first, and second attributes. 

15. The computer system of claim 1. wherein selected ones of the machine readable storage structures of the server 
administrator object further include: 

a structure adapted to store a heart beat interval value indicative of a frequency for the server to send a signal 
to the server administrator to indicate that the server is currently executing; and. 
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a structure adapted to store a maximum value indicative of a maximum number of signals that the server 
administrator may not receive prior to initiating a process to determine whether the server is currently execut- 
ing. 



16. The computer system of claim 1, wherein: 

the server further includes at least one tracing facility; 

the computer system further includes a machine executable tracing structure adapted to output conditional 
information according to at least one tracing facility in the server; and 

selected ones of the machine executable structures of the server administrator object further comprise: 

a structure adapted to define a tracing configuration including a tracing fadlity and a set of trace flags, and a 
structure adapted to store the tracing configuration; and. 

a structure adapted to update the tracing facilities in the server with tracing facilities stored in the server admin- 
istrator. 



1 7. The computer system of claim 16. wherein selected ones of the machine executable structures include: 

a structure that enables at least one trace flag in a specified tracing facility; and. 
a structure that disables at least one trace flag in a specified tracing facility. 

18. The computer system of claim 1 , wherein selected ones of the machine executable structures include: 

a structure adapted to store an identification of each object interface provided by the server; and. 

a structure adapted to store an identification of each object implementation in the server that implements a 

object interface. 

19. A method for determining and manipulating current configuration information for a server on a host computer, the 
method comprising the steps of: 

creating an instance of a persistent first object in a host computer; 

associating the first object with the server during installation of the server, the first object having access to cur- 
rent configuration information of the server; 

receiving by the first object a request from a client for current configuration information about the server; and 
returning to the client current configuration information without invoking the server when the server Is not exe- 
cuting as a process on the host computer. 

20. The method of claim 19. further comprising the step of: 

.1 . ■ • 

storing in the first object current configuration information upon registration of the server; and 

updating selected stored current configuration information each time the server is executed as a process on 

the host computer. 

21 . The method of claim 1 9, further comprising the steps of: 

receiving by the first object a request from a client for current process information about the server; and 
invoking from the first object a second object internal to server to obtain the process information. 

22. The method of claim 1 9. wherein the first object is a server administrator object. 

23. The method of claim 19. further comprising the steps of: 

determining an execution definition for the server; and. 
storing the execution definition in the first object. 

24. The method of claim 23. wherein the execution definition includes a program definition, the method further compris- 
ing the steps of: ^ 



storing a saved program definition for the server in the first object; 
altering the execution definition to provide a new program definition, and. 
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restoring the saved program definition into the execution definition. 

25. The method of claim 23. further comprising the steps of: 

storing a hold down value in the execution definition; and 

suppressing execution of the server according to the hold down value when the server is invoked by a client. 

26. The method of claim 19. further comprising the steps of: 

invoking a pseudo object to determine if the server is currently executing as a process: 
returning a process identifier if the server is executing; and, 
storing a value indicating that the server is executing. 

27. The method of claim 19, further comprising the steps of: 

storing a program definition for an executable application in an execution definition of the server in the first 
object; and 

interposing the executable application according to the program definition when the server is invoked by a cli- 
ent. 

28. The method of claim 19. further comprising the steps of: 

storing in the first object an attribute for enabling or disabling a process for automatically deallocating idle 
objects within the server; 

storing in the first object an attribute for establishing a cycle time for the process; 

storing in the first object an attribute for establishing a maximum time interval for which the server can be idle 
before the server is shutdown by the process; and 

shutting down the server when the maximum time interval is equalled or exceeded. 

29. The method of claim 19. further comprising the steps of: 

storing in the first object an attribute for enabling or disabling logging by an operating system process; 
storing in the first object an attribute for identifying at least one log file for storing information; and. 
storing in the first object an attribute for establishing a maximum file size for the log file. 

30. The method of claim 19, further comprising the steps of: 

storing in the first object a heart beat interval value indicative of a frequency for the server to send a signal to 
the first object to indicate that the server is currently executing; 

storing in the first object a maximum value indicative of a maximum number of signals that the first object may 
not receive prior to initiating a process to determine whether the server is currently executing; and 
initiating a process from the first object to determine whether the server is currently executing if the first object 
does not receive a number of signals equal to or exceeding the maximum number of signals. 

31. The method of claim 19. further comprising the steps of: 

determining a tracing configuration including at least one tracing facility and a set of trace flags in the server; 
storing in the first object the tracing configuration; and 

periodically updating the tracing facilities in the server with tracing facilities stored in the first object. 

32. The method of claim 31 . further comprising the step of: 

selectively enabling at least one trace flag in a specified tracing facility in the first object. 

33. The method of claim 19. further comprising the steps of: 

storing in the first object an identification of each object interface provided by the server; and, 

storing in the first object an identification of each object implementation in the server that implements a object 

interface. 
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